home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XOpenDisplay.z / XOpenDisplay
Encoding:
Text File  |  2002-10-03  |  5.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy((((3333XXXX11111111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))  XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XOpenDisplay, XCloseDisplay - connect or disconnect to X
  10.           server
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           Display *XOpenDisplay(_d_i_s_p_l_a_y__n_a_m_e)
  14.                 char *_d_i_s_p_l_a_y__n_a_m_e;
  15.  
  16.           XCloseDisplay(_d_i_s_p_l_a_y)
  17.                 Display *_d_i_s_p_l_a_y;
  18.  
  19.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  20.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  21.  
  22.           _d_i_s_p_l_a_y__n_a_m_e
  23.                     Specifies the hardware display name, which
  24.                     determines the display and communications domain
  25.                     to be used.  On a POSIX-conformant system, if the
  26.                     display_name is NULL, it defaults to the value of
  27.                     the DISPLAY environment variable.
  28.  
  29.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  30.           The _X_O_p_e_n_D_i_s_p_l_a_y function returns a _D_i_s_p_l_a_y structure that
  31.           serves as the connection to the X server and that contains
  32.           all the information about that X server.  _X_O_p_e_n_D_i_s_p_l_a_y
  33.           connects your application to the X server through TCP or
  34.           DECnet communications protocols, or through some local
  35.           inter-process communication protocol.  If the hostname is a
  36.           host machine name and a single colon (:)  separates the
  37.           hostname and display number, _X_O_p_e_n_D_i_s_p_l_a_y connects using TCP
  38.           streams.  If the hostname is not specified, Xlib uses
  39.           whatever it believes is the fastest transport.  If the
  40.           hostname is a host machine name and a double colon (::)
  41.           separates the hostname and display number, _X_O_p_e_n_D_i_s_p_l_a_y
  42.           connects using DECnet.  A single X server can support any or
  43.           all of these transport mechanisms simultaneously.  A
  44.           particular Xlib implementation can support many more of
  45.           these transport mechanisms.
  46.  
  47.           If successful, _X_O_p_e_n_D_i_s_p_l_a_y returns a pointer to a _D_i_s_p_l_a_y
  48.           structure, which is defined in <_X_1_1/_X_l_i_b._h>.  If
  49.           _X_O_p_e_n_D_i_s_p_l_a_y does not succeed, it returns NULL.  After a
  50.           successful call to _X_O_p_e_n_D_i_s_p_l_a_y, all of the screens in the
  51.           display can be used by the client.  The screen number
  52.           specified in the display_name argument is returned by the
  53.           _D_e_f_a_u_l_t_S_c_r_e_e_n macro (or the _X_D_e_f_a_u_l_t_S_c_r_e_e_n function).  You
  54.           can access elements of the _D_i_s_p_l_a_y and _S_c_r_e_e_n structures
  55.           only by using the information macros or functions.  For
  56.           information about using macros and functions to obtain
  57.           information from the _D_i_s_p_l_a_y structure, see section 2.2.1.
  58.  
  59.           The _X_C_l_o_s_e_D_i_s_p_l_a_y function closes the connection to the X
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy((((3333XXXX11111111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))  XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           server for the display specified in the _D_i_s_p_l_a_y structure
  75.           and destroys all windows, resource IDs (_W_i_n_d_o_w, _F_o_n_t,
  76.           _P_i_x_m_a_p, _C_o_l_o_r_m_a_p, _C_u_r_s_o_r, and _G_C_o_n_t_e_x_t), or other resources
  77.           that the client has created on this display, unless the
  78.           close-down mode of the resource has been changed (see
  79.           _X_S_e_t_C_l_o_s_e_D_o_w_n_M_o_d_e).  Therefore, these windows, resource IDs,
  80.           and other resources should never be referenced again or an
  81.           error will be generated.  Before exiting, you should call
  82.           _X_C_l_o_s_e_D_i_s_p_l_a_y explicitly so that any pending errors are
  83.           reported as _X_C_l_o_s_e_D_i_s_p_l_a_y performs a final _X_S_y_n_c operation.
  84.  
  85.           _X_C_l_o_s_e_D_i_s_p_l_a_y can generate a _B_a_d_G_C error.
  86.  
  87.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  88.           AllPlanes(3X11), XFlush(3X11), XSetCloseDownMode(3X11)
  89.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.